Release 10.1A: OpenEdge Development:
Messaging and ESB

Using serialized connection objects

A serialized connection object contains all the connection information required by a client to connect to a SonicMQ Broker, including userid and password. A SonicMQ administrator creates the serialized connection object as a file using the Sonic Management Console and provides the serialized connection object to the 4GL client. The 4GL client uses the setConnectionFile procedure with the file containing the serialized connection object when creating the messaging session.

The serialized connection object file is used when connecting to a SonicMQ Broker. The following example shows how to use the serialized connection object file MyConnectionObject.sjo:

RUN jms/jmssession.p PERSISTENT SET sessionH ("-SMQConnect"). RUN setConnectionFile IN sessionH ("MyConnectionObject.sjo"). RUN beginSession IN hSession

Creating serialized connection objects

The Sonic Management Console allows an administrator to create serialized connection objects and save them as a file.

To create a serialized connection object file:

Ensure the Domain Manager for SonicMQ is running.
Ensure the Sonic Management Console is started and connected to the Domain Manager.
On the Sonic Management Console menu bar, select Tools and then JMS Administered objects.
Select the File System and navigate to the Directory you want the serialized connection object file to reside, as shown:



Select the Connect button.
In the left pane, select the Object Store directory that you created, as shown:



Select the Connection Factories tab, as shown:



Select the New button and enter the required connection information for Lookup Name (name of serialized connection object file), Connection URL, Default User Name, Default Password, and Confirm Password, as shown:



Note: All other information is optional for the connection object.
Select Update. The serialized connection object appears an entry, as shown:



The serialized connection object file MyConnectionObject.sjo exists in the Object Stores specified directory. A 4GL client uses the file MyConnectionObject.sjo to connect to the SonicMQ Broker.